home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_ghostscript.idb / usr / freeware / catman / u_man / cat1 / djpeg.Z / djpeg
Encoding:
Text File  |  1998-05-21  |  12.7 KB  |  266 lines
  1. /xlv1/freeware/1998.May/ghostscript/3.33+jpeg/gs3.33.diffbuild/jpeg-5a
  2.  
  3.  
  4.  
  5.      DDDDJJJJPPPPEEEEGGGG((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22228888    AAAAuuuugggguuuusssstttt 1111999999994444))))          DDDDJJJJPPPPEEEEGGGG((((1111))))
  6.  
  7.  
  8.  
  9.      NNNNAAAAMMMMEEEE
  10.       djpeg    - decompress a JPEG file to an image file
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ddddjjjjppppeeeegggg    [ _o_p_t_i_o_n_s ] [ _f_i_l_e_n_a_m_e ]
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.       ddddjjjjppppeeeegggg    decompresses the named JPEG file, or the standard
  17.       input    if no file is named, and produces an image file    on the
  18.       standard output.  PBMPLUS (PPM/PGM), BMP, GIF, Targa,    or RLE
  19.       (Utah    Raster Toolkit)    output format can be selected.    (RLE
  20.       is supported only if the URT library is available.)
  21.  
  22.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.       All switch names may be abbreviated; for example, ----ggggrrrraaaayyyyssssccccaaaalllleeee
  24.       may be written ----ggggrrrraaaayyyy or ----ggggrrrr.    Most of    the "basic" switches
  25.       can be abbreviated to    as little as one letter.  Upper    and
  26.       lower    case are equivalent (thus ----GGGGIIIIFFFF is the same as ----ggggiiiiffff).
  27.       British spellings are    also accepted (e.g., ----ggggrrrreeeeyyyyssssccccaaaalllleeee),
  28.       though for brevity these are not mentioned below.
  29.  
  30.       The basic switches are:
  31.  
  32.       ----ccccoooolllloooorrrrssss _N
  33.            Reduce image to at most N colors.  This reduces the
  34.            number of colors    used in    the output image, so that it
  35.            can be displayed    on a colormapped display or stored in
  36.            a colormapped file format.  For example,    if you have an
  37.            8-bit display, you'd need to reduce to 256 or fewer
  38.            colors.
  39.  
  40.       ----qqqquuuuaaaannnnttttiiiizzzzeeee _N
  41.            Same as ----ccccoooolllloooorrrrssss.     ----ccccoooolllloooorrrrssss is the    recommended name,
  42.            ----qqqquuuuaaaannnnttttiiiizzzzeeee is provided only for backwards    compatibility.
  43.  
  44.       ----ffffaaaasssstttt
  45.            Select recommended processing options for fast, low
  46.            quality output.    (The default options are chosen    for
  47.            highest quality output.)     Currently, this is equivalent
  48.            to ----ddddcccctttt ffffaaaasssstttt ----nnnnoooossssmmmmooooooootttthhhh ----oooonnnneeeeppppaaaassssssss ----ddddiiiitttthhhheeeerrrr oooorrrrddddeeeerrrreeeedddd.
  49.  
  50.       ----ggggrrrraaaayyyyssssccccaaaalllleeee
  51.            Force gray-scale    output even if JPEG file is color.
  52.            Useful for viewing on monochrome    displays; also,    ddddjjjjppppeeeegggg
  53.            runs noticeably faster in this mode.
  54.  
  55.       ----ssssccccaaaalllleeee _M/_N
  56.            Scale the output    image by a factor M/N.    Currently the
  57.            scale factor must be 1/1, 1/2, 1/4, or 1/8.  Scaling is
  58.            handy if    the image is larger than your screen; also,
  59.            ddddjjjjppppeeeegggg runs much faster when scaling down    the output.
  60.  
  61.  
  62.  
  63.  
  64.      Page 1                         (printed 5/12/98)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      DDDDJJJJPPPPEEEEGGGG((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22228888    AAAAuuuugggguuuusssstttt 1111999999994444))))          DDDDJJJJPPPPEEEEGGGG((((1111))))
  72.  
  73.  
  74.  
  75.       ----bbbbmmmmpppp Select BMP output format    (Windows flavor).  8-bit
  76.            colormapped format is emitted if    ----ccccoooolllloooorrrrssss    or ----ggggrrrraaaayyyyssssccccaaaalllleeee
  77.            is specified, or    if the JPEG file is gray-scale;
  78.            otherwise, 24-bit full-color format is emitted.
  79.  
  80.       ----ggggiiiiffff Select GIF output format.  Since    GIF does not support
  81.            more than 256 colors, ----ccccoooolllloooorrrrssss 222255556666 is assumed (unless
  82.            you specify a smaller number of colors).
  83.  
  84.       ----oooossss2222 Select BMP output format    (OS/2 1.x flavor).  8-bit
  85.            colormapped format is emitted if    ----ccccoooolllloooorrrrssss    or ----ggggrrrraaaayyyyssssccccaaaalllleeee
  86.            is specified, or    if the JPEG file is gray-scale;
  87.            otherwise, 24-bit full-color format is emitted.
  88.  
  89.       ----ppppnnnnmmmm Select PBMPLUS (PPM/PGM)    output format (this is the
  90.            default format).     PGM is    emitted    if the JPEG file is
  91.            gray-scale or if    ----ggggrrrraaaayyyyssssccccaaaalllleeee is specified; otherwise PPM
  92.            is emitted.
  93.  
  94.       ----rrrrlllleeee Select RLE output format.  (Requires URT    library.)
  95.  
  96.       ----ttttaaaarrrrggggaaaa
  97.            Select Targa output format.  Gray-scale format is
  98.            emitted if the JPEG file    is gray-scale or if ----ggggrrrraaaayyyyssssccccaaaalllleeee
  99.            is specified; otherwise,    colormapped format is emitted
  100.            if ----ccccoooolllloooorrrrssss is specified;    otherwise, 24-bit full-color
  101.            format is emitted.
  102.  
  103.       Switches for advanced    users:
  104.  
  105.       ----ddddcccctttt iiiinnnntttt
  106.            Use integer DCT method (default).
  107.  
  108.       ----ddddcccctttt ffffaaaasssstttt
  109.            Use fast    integer    DCT (less accurate).
  110.  
  111.       ----ddddcccctttt ffffllllooooaaaatttt
  112.            Use floating-point DCT method.  The floating-point
  113.            method is the most accurate, but    will be    the slowest
  114.            unless your machine has very fast floating-point
  115.            hardware.  Also note that results of the    floating-point
  116.            method may vary slightly    across machines, while the
  117.            integer methods should give the same results
  118.            everywhere.  The    fast integer method is much less
  119.            accurate    than the other two.
  120.  
  121.       ----ddddiiiitttthhhheeeerrrr ffffssss
  122.            Use Floyd-Steinberg dithering in    color quantization.
  123.  
  124.       ----ddddiiiitttthhhheeeerrrr oooorrrrddddeeeerrrreeeedddd
  125.            Use ordered dithering in    color quantization.
  126.  
  127.  
  128.  
  129.  
  130.      Page 2                         (printed 5/12/98)
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      DDDDJJJJPPPPEEEEGGGG((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22228888    AAAAuuuugggguuuusssstttt 1111999999994444))))          DDDDJJJJPPPPEEEEGGGG((((1111))))
  138.  
  139.  
  140.  
  141.       ----ddddiiiitttthhhheeeerrrr nnnnoooonnnneeee
  142.            Do not use dithering in color quantization.  By
  143.            default,    Floyd-Steinberg    dithering is applied when
  144.            quantizing colors; this is slow but usually produces
  145.            the best    results.  Ordered dither is a compromise
  146.            between speed and quality; no dithering is fast but
  147.            usually looks awful.  Note that these switches have no
  148.            effect unless color quantization    is being done.
  149.            Ordered dither is only available    in ----oooonnnneeeeppppaaaassssssss mode.
  150.  
  151.       ----mmmmaaaapppp _f_i_l_e
  152.            Quantize    to the colors used in the specified image
  153.            file.  This is useful for producing multiple files with
  154.            identical color maps, or    for forcing a predefined set
  155.            of colors to be used.  The _f_i_l_e must be a GIF or    PPM
  156.            file. This option overrides ----ccccoooolllloooorrrrssss and ----oooonnnneeeeppppaaaassssssss.
  157.  
  158.       ----nnnnoooossssmmmmooooooootttthhhh
  159.            Use a faster, lower-quality upsampling routine.
  160.  
  161.       ----oooonnnneeeeppppaaaassssssss
  162.            Use one-pass instead of two-pass    color quantization.
  163.            The one-pass method is faster and needs less memory,
  164.            but it produces a lower-quality image.  ----oooonnnneeeeppppaaaassssssss    is
  165.            ignored unless you also say ----ccccoooolllloooorrrrssss _N.  Also, the one-
  166.            pass method is always used for gray-scale output    (the
  167.            two-pass    method is no improvement then).
  168.  
  169.       ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy _N
  170.            Set limit for amount of memory to use in    processing
  171.            large images.  Value is in thousands of bytes, or
  172.            millions    of bytes if "M"    is attached to the number.
  173.            For example, ----mmmmaaaaxxxx 4444mmmm selects 4000000 bytes.  If more
  174.            space is    needed,    temporary files    will be    used.
  175.  
  176.       ----oooouuuuttttffffiiiilllleeee _n_a_m_e
  177.            Send output image to the    named file, not    to standard
  178.            output.
  179.  
  180.       ----vvvveeeerrrrbbbboooosssseeee
  181.            Enable debug printout.  More ----vvvv's give more output.
  182.            Also, version information is printed at startup.
  183.  
  184.       ----ddddeeeebbbbuuuugggg
  185.            Same as ----vvvveeeerrrrbbbboooosssseeee.
  186.  
  187.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  188.       This example decompresses the    JPEG file foo.jpg,
  189.       automatically    quantizes to 256 colors, and saves the output
  190.       in GIF format    in foo.gif:
  191.  
  192.            ddddjjjjppppeeeegggg ----ggggiiiiffff _f_o_o._j_p_g >>>> _f_o_o._g_i_f
  193.  
  194.  
  195.  
  196.      Page 3                         (printed 5/12/98)
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      DDDDJJJJPPPPEEEEGGGG((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22228888    AAAAuuuugggguuuusssstttt 1111999999994444))))          DDDDJJJJPPPPEEEEGGGG((((1111))))
  204.  
  205.  
  206.  
  207.      HHHHIIIINNNNTTTTSSSS
  208.       To get a quick preview of an image, use the ----ggggrrrraaaayyyyssssccccaaaalllleeee
  209.       and/or ----ssssccccaaaalllleeee    switches.  ----ggggrrrraaaayyyyssssccccaaaalllleeee ----ssssccccaaaalllleeee 1111////8888 is the
  210.       fastest case.
  211.  
  212.       Several options are available    that trade off image quality
  213.       to gain speed.  ----ffffaaaasssstttt    turns on the recommended settings.
  214.  
  215.       ----ddddcccctttt ffffaaaasssstttt and/or ----nnnnoooossssmmmmooooooootttthhhh gain speed    at a small sacrifice
  216.       in quality.  When producing a    color-quantized    image,
  217.       ----oooonnnneeeeppppaaaassssssss ----ddddiiiitttthhhheeeerrrr oooorrrrddddeeeerrrreeeedddd is fast but much lower quality than
  218.       the default behavior.     ----ddddiiiitttthhhheeeerrrr nnnnoooonnnneeee may give acceptable
  219.       results in two-pass mode, but    is seldom tolerable in one-
  220.       pass mode.
  221.  
  222.       If you are fortunate enough to have very fast    floating point
  223.       hardware, ----ddddcccctttt ffffllllooooaaaatttt may be even faster than ----ddddcccctttt ffffaaaasssstttt.
  224.  
  225.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  226.       JJJJPPPPEEEEGGGGMMMMEEEEMMMM
  227.            If this environment variable is set, its    value is the
  228.            default memory limit.  The value    is specified as
  229.            described for the ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy switch.  JJJJPPPPEEEEGGGGMMMMEEEEMMMM overrides
  230.            the default value specified when    the program was
  231.            compiled, and itself is overridden by an    explicit
  232.            ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy.
  233.  
  234.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  235.       ccccjjjjppppeeeegggg(1), rrrrddddjjjjppppggggccccoooommmm(1), wwwwrrrrjjjjppppggggccccoooommmm(1)
  236.       ppppppppmmmm(5), ppppggggmmmm(5)
  237.       Wallace, Gregory K.  "The JPEG Still Picture Compression
  238.       Standard", Communications of the ACM,    April 1991 (vol. 34,
  239.       no. 4), pp. 30-44.
  240.  
  241.      AAAAUUUUTTTTHHHHOOOORRRR
  242.       Independent JPEG Group
  243.  
  244.      BBBBUUUUGGGGSSSS
  245.       Arithmetic coding is not supported for legal reasons.
  246.  
  247.       Still    not as fast as we'd like.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.      Page 4                         (printed 5/12/98)
  263.  
  264.  
  265.  
  266.